home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / ra / rtool115.zip / R_TOOLS.DOC < prev    next >
Text File  |  1994-05-01  |  22KB  |  434 lines
  1.  
  2.  
  3.                  ▄▄▄▄▄▄▄ ▄▄▄ ▄▄▄ ▄▄▄▄▄▄  ▄▄▄ ▄▄▄  ▄▄▄ ▄▄▄▄▄▄▄
  4.                  █ ▄▄▄ █ █ █ █ █ █ ▄▄ ▀█ █▄▀█▀▄█ █▀▄█ █ ▄▄▄▄█
  5.                  █ ▄ ▄▄█ █ █▄█ █ █ █▄▀ █  ▀█ █▀  ▀▀▀  █▄▄▄▄ █
  6.                  █▄█▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄█▀   █▄█        █▄▄▄▄▄█
  7.                    ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄     ▄▄▄▄▄▄▄
  8.                    █▄▄ ▄▄█ █ ▄▄▄ █ █ ▄▄▄ █ █ █     █ ▄▄▄▄█
  9.                      █ █   █ █▄█ █ █ █▄█ █ █ █▄▄▄▄ █▄▄▄▄ █
  10.                      █▄█   █▄▄▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄▄█
  11.  
  12.                            Release 1.15 - May 1994
  13.  
  14.                      1993-94 (C) Chief Data Recovery Ltd.
  15.  
  16.                              All Rights Reserved.
  17.  
  18.  
  19.     ┌──────────────────────────────────────────────────────────────────────╖
  20.     │ INTRODUCTION                                                         ║
  21.     ╘══════════════════════════════════════════════════════════════════════╝
  22.     During my operation of  Rudy's Place BBS I wrote lots of small utilities
  23.     to help me maintain  the BBS.  As  I needed  these tools,  I imagin that
  24.     there are other Sysops  that will  find some of these utilities suitable
  25.     for their needs, so I decided to distribute them to the free world.
  26.  
  27.  
  28.     ┌──────────────────────────────────────────────────────────────────────╖
  29.     │ TOOLS DESCRIPTION                                                    ║
  30.     ╘══════════════════════════════════════════════════════════════════════╝
  31.     The package include  several utilities,  each  is a  stand alone utility
  32.     which have nothing to do with other programs in the package. Each of the
  33.     programs is described  differently,  as if it was distributed seperatly.
  34.     Tools that handles  the users files must be run from the same disrectory
  35.     where USERSxxx.BBS files are found.  Please note that  all  RA  specific
  36.     utilities are compatible with RA 2.00 only.   They should not be used on
  37.     RA 1.11 or earlier versions.
  38.  
  39.  
  40.     ┌──────────────────────────────────────────────────────────────────────╖
  41.     │ DIZ.EXE                                                              ║
  42.     ╘══════════════════════════════════════════════════════════════════════╝
  43.     This little  program  strip  FILE_ID.DIZ  form  ZIP,  ARJ  and LZH  into
  44.     FILES.BBS.  It will not check for the existent of the file in FILES.BBS.
  45.  
  46.                             USAGE: DIZ filemask.ext
  47.  
  48.     DIZ requires that PKUNZIP.EXE,  ARJ.EXE and LHA.EXE will be somewhere in
  49.     the DOS Path for each archive type.  Note that  DIZ  does not check if a
  50.     file description is already exist in FILES.BBS.
  51.  
  52.  
  53.     ┌──────────────────────────────────────────────────────────────────────╖
  54.     │ ZID.EXE                                                              ║
  55.     ╘══════════════════════════════════════════════════════════════════════╝
  56.     ZipID is used  to  identify ZIP  version that  ZIP archives  were packed
  57.     with.
  58.  
  59.                         USAGE: ZID filemask.ext [/1|/2]
  60.  
  61.     It will list all files with their version of ZIP.  If /1 or /2 are used,
  62.     ZID will display only files that were created with ZIP 1.xx or 2.xx.
  63.  
  64.  
  65.     ┌──────────────────────────────────────────────────────────────────────╖
  66.     │ WIPE.EXE                                                             ║
  67.     ╘══════════════════════════════════════════════════════════════════════╝
  68.     Sometimes,  when USERON.BBS  is messed up from any reason,  this program
  69.     can clear the USERON.BBS file and create an empty one.
  70.  
  71.                                  USAGE: WIPE n
  72.  
  73.     It will create an  empty USERON.BBS file for 'n' nodes.  Compatible with
  74.     RA 2.00. Do not use in RA 1.xx.
  75.  
  76.  
  77.     ┌──────────────────────────────────────────────────────────────────────╖
  78.     │ NODEFIND.EXE                                                         ║
  79.     ╘══════════════════════════════════════════════════════════════════════╝
  80.     This utility will search the nodelist for a specific node address.
  81.  
  82.               USAGE: NODEFIND [d:\path\]nodelist.xxx zone:net:node
  83.  
  84.     where nodelist.xxx  is   the  name  of  the  nodelist  file,   including
  85.     extension, and the zone:net:node is the complete node number address. No
  86.     wildcards are allowed in both nodelist name and node address.
  87.  
  88.  
  89.     ┌──────────────────────────────────────────────────────────────────────╖
  90.     │ BUILDIDX.EXE                                                         ║
  91.     ╘══════════════════════════════════════════════════════════════════════╝
  92.     It happends to  me,  sometimes,  that the USERSIDX.BBS is trushed and so
  93.     when users are logging in, RA recognizes them as new users. BUILDIDX.EXE
  94.     will rebuild RA 2.00 USERSIDX.BBS file from scratch.
  95.  
  96.                                 USAGE: BUILDIDX
  97.  
  98.     The program  should  run  in  the same  directory where  your USERS*.BBS
  99.     resides and the RA should not run during BUILDIDX's execution.
  100.  
  101.  
  102.     ┌──────────────────────────────────────────────────────────────────────╖
  103.     │ BUILDXI.EXE                                                          ║
  104.     ╘══════════════════════════════════════════════════════════════════════╝
  105.     The USERSXI.BBS file in RA 2.00 does not hold any data,  and sometime it
  106.     may trash for several reasons. BUILDXI will rebuild an empty USERSXI.BBS
  107.     file according to the number of users in USERS.BBS.
  108.  
  109.                                  USAGE: BUILDXI
  110.  
  111.     The program  should  run  in  the same  directory where  your USERS*.BBS
  112.     resides and the RA should not run during BUILDIDX's execution.
  113.  
  114.  
  115.     ┌──────────────────────────────────────────────────────────────────────╖
  116.     │ FIXALIAS.EXE                                                         ║
  117.     ╘══════════════════════════════════════════════════════════════════════╝
  118.     There are users in  the user  file that  their alias (handle) is not set
  119.     and when entering a  program which  uses aliases  (like ChatManager with
  120.     Handles set to ON), there is no name listed in the user's list. FIXALIAS
  121.     will fill these empty  fields with  the user's  name if the alias is not
  122.     available.
  123.  
  124.                                 USAGE: FIXALIAS
  125.  
  126.     The program  should  run  in  the same  directory where  your USERS*.BBS
  127.     resides and the RA should not run during BUILDIDX's execution.
  128.  
  129.  
  130.     ┌──────────────────────────────────────────────────────────────────────╖
  131.     │ USERSDUP.EXE                                                         ║
  132.     ╘══════════════════════════════════════════════════════════════════════╝
  133.     UsersDUP will search  your USERS.BBS  for duplicate  user entries.  If a
  134.     user record is  found more then once,  it will be reported to the screen
  135.     along with the record numbers of the records.
  136.  
  137.                                 USAGE: USERSDUP
  138.  
  139.     UsersDUP may run while RA is up and running.  It will not write anything
  140.     to the users file.
  141.  
  142.  
  143.     ┌──────────────────────────────────────────────────────────────────────╖
  144.     │ TRUNC.EXE                                                            ║
  145.     ╘══════════════════════════════════════════════════════════════════════╝
  146.     TRUNC is a utility  to truncate  files to  a spesific  size.  It may  be
  147.     useful when fixing damaged files or experamenting with disk space. TRUNC
  148.     works in both ways  ; It can  truncate files to a size smaller or bigger
  149.     the file's original size.
  150.  
  151.                          USAGE: TRUNC filename.ext size
  152.  
  153.     'filename.ext' may  be  any DOS  filename in  the current  directory and
  154.     'size' is the size you want to truncate the file to.
  155.  
  156.  
  157.     ┌──────────────────────────────────────────────────────────────────────╖
  158.     │ UCHECK.EXE                                                           ║
  159.     ╘══════════════════════════════════════════════════════════════════════╝
  160.     UCHECK is a utility  to check and validate the users files.  UCHECK will
  161.     check if the  size  of  the  users files  match,  validate the  USERSIDX
  162.     information,  check  for  deleted  users  and will  check for  duplicate
  163.     handles and will fix them.
  164.  
  165.                                  USAGE: UCHECK
  166.  
  167.     UCHECK will  recommend  actions  if  errors found.  UCHECK  also provide
  168.     errorlevels for  batch processing.  It  will exit  with errorlevel  0 if
  169.     everything checks  OK,  errorlevel 1 if  users  files  can not be found,
  170.     opened and errorlevel 2 if a sysop actions is needed and errorlevel 3 if
  171.     a fatal error detected  in the  users files  (eg. index mismatch,  wrong
  172.     file sizes).
  173.  
  174.  
  175.     ┌──────────────────────────────────────────────────────────────────────╖
  176.     │ FDPW.EXE                                                             ║
  177.     ╘══════════════════════════════════════════════════════════════════════╝
  178.     FDPW is a utility to syncronize session passwords with your pollers.  It
  179.     reads the FrontDoor  log  file  and  searches for  "Unexpected password"
  180.     error messages and adds the missing passwords to the PASSWORD.FD file in
  181.     the FrontDoor directory.  The  FD= environment variable  must be set and
  182.     point to the FrontDoor directory before FDPW can run.
  183.  
  184.                                USAGE: FDPW fd.log
  185.  
  186.     You must specify the FrontDoor log filename in the command line.
  187.     FDPW runs on FrontDoor 2.02 or higher.
  188.  
  189.  
  190.     ┌──────────────────────────────────────────────────────────────────────╖
  191.     │ RENUM.EXE                                                            ║
  192.     ╘══════════════════════════════════════════════════════════════════════╝
  193.     RENUM is a utility to rename files according to sequential numbers, just
  194.     like FrontDoor's Editro (FM) renames files in the NetMail directory.
  195.  
  196.                       USAGE: RENUM filemask.ext [newext]
  197.  
  198.     RENUM must run  in the same directory where the files to be renames are.
  199.     the [newext] parameter is optional and will be used as the new extension
  200.     for the renumbed files. Default extension is [NUM].
  201.  
  202.     For example,  running 'RENUM  *.LIS BBS' will  rename all files with the
  203.     extension of [LIS] to  sequential files with the extension of [BBS] (ie.
  204.     1.BBS, 2.BBS, 3.BBS etc.).
  205.  
  206.     Because the operation  of RENUM is non-reversable,  RENUM will create an
  207.     UNDO batch file  named REN_UNDO.BAT.  If you wish to rename the files to
  208.     their original names, just run this batchfile.
  209.  
  210.  
  211.     ┌──────────────────────────────────────────────────────────────────────╖
  212.     │ GUB_SET.EXE                                                          ║
  213.     ╘══════════════════════════════════════════════════════════════════════╝
  214.     GUB_SET is a  Global USERS.BBS Set utility.  It allows global changes to
  215.     be applied to FILES.BBS.
  216.  
  217.                USAGE: GUB_SET field1=value1 [field2=value2] ...
  218.  
  219.     The fields that may be changed and their valid values are as follows:
  220.  
  221.     Field      Meaning                          Values
  222.     ────────── ──────────────────────────────── ───────────────
  223.     ANSI=      Toggle ANSI                      ON or OFF
  224.     AVATAR=    Toggle AVATAR                    ON or OFF
  225.     BILL=      Toggle post bill                 ON or OFF
  226.     CALLS=     Set number of calls              0 to 2147483647
  227.     CLS=       Toggle Clear Screen              ON or OFF
  228.     CREDIT=    Set NetMail Credit               0 to 2147483647
  229.     DELETE=    (un)Delete all users             ON or OFF
  230.     DLK=       Set amount of downloads in K.    0 to 2147483647
  231.     DOWNLOADS= Set number of downloads          0 to 2147483647
  232.     FLAGxy=    Toggle user flags (xy = A1-D8)   ON or OFF
  233.     GROUP=     Set group                        0 to 65535
  234.     GUEST      Toggle Guest flag                ON or OFF
  235.     HIDDEN=    Toggle Hidden flag               ON or OFF
  236.     HOTKEY=    Toggle hotkeys                   ON or OFF
  237.     LANG=      Set Language                     0 to 255
  238.     MAILSCAN=  Toggle EchoMail mailbox scan     ON or OFF
  239.     MORE=      Toggle More prompt               ON or OFF
  240.     MSGED=     Toggle FullScreen Msg Editor     ON or OFF
  241.     MSGVU=     Toggle FullScreen Msg Viewer     ON or OFF
  242.     NOKILL=    Toggle NoKill flag               ON or OFF
  243.     PAGE=      Toggle Page priority             ON or OFF
  244.     PROTOCOL=  Set default protocol             AlphaBetic
  245.     PWDCHNGE=  Set Last password change         0 to 255
  246.     QUIET=     Set Quiet mode                   ON to OFF
  247.     SEC=       Set security level               0 to 65535
  248.     TODAYK=    Set amount of downloads today    0 to 2147483647
  249.     ULK=       Set amount of uploads in K.      0 to 2147483647
  250.     UPLOADS=   Set number of uploads            0 to 2147483647
  251.     XFER=      Toggle XFER priority             ON to OFF
  252.  
  253.     Up to 10 fields to change may be specified in one command.
  254.  
  255.     Each field should be followed by the '=' sign,  followed by a value with
  256.     no spaces between them. Different fields should be seperated by a space.
  257.     The command line  parameters are NOT case sensitive and may apear in any
  258.     order. Please note  that there  is no  validation for different field in
  259.     the command line,  ie.  if you specify ANSI=OFF and MSGED=ON - it's your
  260.     problem.
  261.  
  262.     For example,  running 'GUB_SET  SEC=0' will lockout  all users.  running
  263.     'GUB_SET FlagA1=ON Credit=10' will  set flag A1 and change the credit to
  264.     a value of 10 for all users.
  265.  
  266.     If you change the  UL / DL  ratio  and want to  reset  all users UL / DL
  267.     statistics, run: "GUB_SET UPLOADS=0 DOWNLOADS=0 ULK=0 DLK=0 TODAYK=0"
  268.  
  269.  
  270.     ┌──────────────────────────────────────────────────────────────────────╖
  271.     │ RAREPORT.EXE                                                         ║
  272.     ╘══════════════════════════════════════════════════════════════════════╝
  273.     RAReport is a  utility to  create readable text reports of file and mail
  274.     areas and groups.  It reads  your FILES.RA  and MESSAGES.RA (with F or M
  275.     Group files) and create  a sorted list of all areas.  In each report,  a
  276.     Group 0 is created to list areas that are not groupd.
  277.  
  278.                       USAGE: RAREPORT /F|/M [/G] [OutFile]
  279.  
  280.     You must specify either  /F or  /M to  create Files or Messages reports.
  281.     The /G tells RAReport to list group names only.  An optional output file
  282.     may be specified in  the command line.  If not specified,  RAReport will
  283.     default to RAREPORT.LST in the current directory.
  284.  
  285.     for example: 'RAREPORT /F  FILES.LST' will create full file area list in
  286.     FILES.LST in the current directory. 'RAREPORT /M /G' will create list of
  287.     message groups in RAREPORT.LST in the current directory.
  288.  
  289.  
  290.     ┌──────────────────────────────────────────────────────────────────────╖
  291.     │ RA_CLEAN.EXE                                                         ║
  292.     ╘══════════════════════════════════════════════════════════════════════╝
  293.     RA_Clean utility checks  your menus,  textfiles  and questionnaire files
  294.     for orphan files.  This  means that  RA_Clean will report any menus that
  295.     are not linked to other menus and textfiles and questionnaire files that
  296.     are not listed in  any menu.  RA_Clean  checks every  files against  the
  297.     internal RA list, a user defined exclude file and the menus.
  298.  
  299.     The user defined exclude file should be named RA_CLEAN.EXC and should be
  300.     place somewhere  in   the  DOS   path  or   in  the  same  directory  as
  301.     RA_CLEAN.EXE.  This is  a plain  text file  with one  filemask per line.
  302.     Empty lines and lines that begins with a semicolon (;) are ignored.  The
  303.     exclude file may  be used  to specify  names of screens that are used by
  304.     door programs  such  as  FileDoor  etc.  The  exclude  file should  look
  305.     something like this:
  306.  
  307.     ------------------------------------------------------------------------
  308.     ; RA_Clean Sample Exclude File.
  309.     ;
  310.     ; FileDoor External Screens:
  311.     ERR_10FL.A??
  312.     HLP_DOWN.A??
  313.     MNU_DOWN.A??
  314.     MNU_UP.A??
  315.     ; And so on...
  316.     ;
  317.     ; ALLFIX Door external screens:
  318.     FIXMENU.A*
  319.     FIXHELP?.A*
  320.     ;
  321.     ; Etc, Etc...
  322.     ;
  323.     -----------------------------------------------------------------------
  324.  
  325.     There is no limit for the size of the exclude file.
  326.  
  327.                            USAGE: RA_CLEAN [/L#] [/R]
  328.  
  329.     By default, RA_Clean reports only to the screen.  If the /R command line
  330.     parameters  is  specified,  a  report  file named  RA_CLEAN.LOG will  be
  331.     created in the current directory and will list all orphan files.
  332.  
  333.     The /L# is used  to specify  the language  set of  files to  check.  The
  334.     default is language  1, which is  usually English.  If you want to check
  335.     language number 5, use the /L5 command line parameter.
  336.  
  337.     If orphan menus are  found,  RA_Clean will  stop and  you have to remove
  338.     these menus from  your menus directory before RA_Clean can continue.  In
  339.     this case, you'll have to run RA_Clean again.
  340.  
  341.  
  342.     ┌──────────────────────────────────────────────────────────────────────╖
  343.     │ GMR_SET.EXE                                                          ║
  344.     ╘══════════════════════════════════════════════════════════════════════╝
  345.     GMR_Set is a  Global Message.Ra  editor that  allow changes in the three
  346.     most common changed  fields.  These are the fields that are used to tell
  347.     RAMSG the details needed  to purge messages from the messagebase.  These
  348.     fields are known as DaysKill, DrcvKill and CountKill.
  349.  
  350.                             USAGE: GMR_SET [options]
  351.  
  352.     The options are:
  353.  
  354.                       DOLD=nn - Set DaysKill limit.
  355.                       DRCV=nn - Set RecvKill limit.
  356.                       MSGS=nn - Set CountKill limit.
  357.                      /L      - Process Local areas only.
  358.                      /E      - Process Echomail areas only.
  359.                      /N      - Process Netmail areas only.
  360.                      /Gnn    - Process Group nn areas only.
  361.  
  362.     Only one type of  change is  allowed in a single run.  If a field is not
  363.     specified, it will remain unchanged.
  364.     For example,  if you  want to set the limit of 500 messages in all local
  365.     areas, use the command 'GMR_SET MSGS=500 /L'. If you want to set maximum
  366.     number of messages to  300 and the  maximum of  8 days old  in all areas
  367.     that are under group 5, use the command 'GMR_SET MSGS=300 DOLD=8 /G5'.
  368.  
  369.  
  370.     ┌──────────────────────────────────────────────────────────────────────╖
  371.     │ NETCLEAN.EXE                                                         ║
  372.     ╘══════════════════════════════════════════════════════════════════════╝
  373.     NetClean is  a  tool  that  removes Netmail  messages that  have a  file
  374.     attached to them but the file does not exist.
  375.  
  376.                                USAGE: NETCLEAN
  377.  
  378.     No command  line  parameters are  required.  NetClean must  run in  your
  379.     NetMail directory, where all *.MSG may be found.
  380.  
  381.  
  382.     ┌──────────────────────────────────────────────────────────────────────╖
  383.     │ WARRANTY                                                             ║
  384.     ╘══════════════════════════════════════════════════════════════════════╝
  385.     None, Whatsoever.  These programs  are used daily on Rudy's Place BBS so
  386.     they should work for you too.
  387.  
  388.  
  389.     ┌──────────────────────────────────────────────────────────────────────╖
  390.     │ HISTORY                                                              ║
  391.     ╘══════════════════════════════════════════════════════════════════════╝
  392.     Release 1.00 - First public release.
  393.     Release 1.01 - Fixed nasty bug in NODEFIND program.
  394.                    Fixed ZID to support full path.
  395.     Release 1.02 - Added FIXALIAS and BUILDXI utilities.
  396.     Release 1.03 - Improved speed of BUILDIDX in about 300%.
  397.     Release 1.04 - NODEFIND  fixed  to run  even if  FrontDoor is  using the
  398.                    Nodelist.
  399.     Release 1.05 - Added USERSDUP utility.
  400.     Release 1.06 - Added TRUNC utility.
  401.     Release 1.07 - Added UCHECK utility.
  402.     Release 1.08 - Added FDPW utility.
  403.     Release 1.09 - Fixed spelling mistakes in UCHECK.
  404.                    FDPW can now run even if FrontDoor is running.
  405.     Release 1.10 - Added RENUM utility.
  406.     Release 1.11 - Added GUB_SET utility.
  407.     Release 1.12 - Changes in UCHECK.EXE.
  408.                    Added RAREPORT.EXE.
  409.     Release 1.13 - Added RA_CLEAN.EXE.
  410.                    Added more field changes in GUB_SET.EXE.
  411.     Release 1.14 - Added GMR_SET.EXE.
  412.     Release 1.15 - BUILDIDX can now run while system is online.
  413.                    BUILDXI can now run while system is online.
  414.                    Added NETCLEAN.EXE.
  415.                    BUILDIDX is now about 40% faster but requires about
  416.                    140KB of free memory to run.
  417.  
  418.  
  419.     ┌──────────────────────────────────────────────────────────────────────╖
  420.     │ COMMENTS                                                             ║
  421.     ╘══════════════════════════════════════════════════════════════════════╝
  422.     Cemments may be  sent to Nemrod Kedem in one of the following addresses:
  423.  
  424.                            FidoNet          2:403/138
  425.                            VirNet             9:972/0
  426.                            BetaNet         144:1442/2
  427.                            FD_Net          255:3972/0
  428.                            Compuserve       100274,73
  429.                            Fax         +972-8-403-295
  430.                            BBS        +972-3-966-7562
  431.                            Voice      +972-3-966-9312
  432.  
  433.                                    -= EOF =-
  434.